To customize the format of these automatically-generated certificate file names, you must edit the appsettings.Production.json file of the rest.provision web service:

1. As an administrator, open the appsettings.Production.json file in a text editor.

   By default, this is:

   C:\Program Files\Intercede\MyID\rest.provision\appsettings.Production.json

   This file is the override configuration file for the appsettings.json file for the web service. If this file does not already exist, you must create it in the same folder as the appsettings.json file.

2. In the MyID section, edit the CertificateFileName section.

   If this section does not exist, you must add it.

   The format is:

   Copy

   {
     "MyID": {
       ...
       "CertificateFileName": {
         "default": "[[People.LogonName]] [[PolicyName]]"
       },
       ...
     }
   }  

   You can use the following substitutions:

   • [[People.FieldName]] – where FieldName is the name of a field in the vPeopleUserAccounts view in the MyID database.

     For example:

     [[People.LogonName]]

     [[People.GroupName]]

   • [[PolicyName]] – the friendly name for the policy.

   • [[DateTime.Format]] – where Format is the date and time format you want to use.

     Sample codes:

     • yyyy – year; for example, 2021.

     • MM – two-digit month; for example, 09.

     • MMM – short month; for example, Sep.

     • MMMM – full month; for example, September.

     • dd – two-digit day; for example, 02.

     • HH – hour in 24-hour clock; for example, 23.

     • hh – hour in 12-hour clock; for example, 11.

     • mm – minutes; for example, 29.

     • ss – seconds; for example, 45.

     You can use - to separate the components of the date and time. Do not use : or / as this causes errors when creating the filename. Any characters you use must be valid for filenames.

     Examples:

     • [[DateTime.yyyy-MM-dd]]

     • [[DateTime.yyyy-MM-dd HHmm]]

     Note: Times are in UTC.

   • [[RandomNumber.####]] – adds a random number to the file name. The number of digits in the random number is determined by the number of # signs you include.

3. Save the appsettings.Production.json file.

4. Recycle the web service app pool:

   1. On the MyID web server, in Internet Information Services (IIS) Manager, select Application Pools.
   2. Right-click the myid.rest.provision.pool application pool, then from the pop-up menu click Recycle.

   This ensures that the web service has picked up the changes to the configuration file.

{
  "MyID": {
    ...
    "CertificateFileName": {
      "default": "[[People.LogonName]] [[PolicyName]]",
      "policy": [
        {
          "name": "PolicyFriendlyName",
          "fileName": "FilenameFormat"
        }
      ]
    },
    ...
  }
}  

"policy": [
  {
    "name": "PolicyFriendlyName",
    "fileName": "FilenameFormat"
  },
  {
    "name": "PolicyFriendlyName 2",
    "fileName": "FilenameFormat 2"
  }  
]

"CertificateFileName": {
  "default": "[[People.LogonName]] [[PolicyName]] [[DateTime.yyyy-MM-dd HHmm]]",
  "policy": [
    {
      "name": "PIVSigning (2)",
      "fileName": "[[People.LogonName]] Signing Certificate [[DateTime.yyyy-MM-dd HHmm]] [[RandomNumber.########]]"
    },
    {
      "name": "PIVEncryption (2)",
      "fileName": "[[People.LogonName]] Encryption Certificate [[DateTime.yyyy-MM-dd HHmm]]"
    },
  ]
},